home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / vino.z / vino
Encoding:
Text File  |  2002-10-03  |  19.0 KB  |  463 lines

  1.  
  2.  
  3.  
  4. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vino - on-board video input system for Indy
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      Vino is the builtin video on the Indy System.  It supports three
  13.      different types of inputs: digital, composite, and S-Video (Y/C).  The
  14.      digital input is for use with the IndyCam camera and the analog inputs
  15.      are for use with standard video equipment.  Vino supports input on the
  16.      digital and one of the two analog ports simultaneously.  The analog
  17.      inputs may be in either PAL or NTSC formats and a variety of controls are
  18.      available that allow the user or programmer to set various parameters
  19.      used for the analog to digital conversion.
  20.  
  21.      Using Vino, it is possible to read live video into the computer's memory
  22.      which can then be displayed in a graphics window on the screen or further
  23.      processed by the application.  Using the VL programming library (see
  24.      _v_l_i_n_t_r_o(3)), a program can request video in either monochrome, low
  25.      resolution color, or two forms of high resolution color.  The video image
  26.      can be captured in either full or reduced size formats.
  27.  
  28.      The video control program, _v_i_d_e_o_p_a_n_e_l(1) allows the user to control the
  29.      default inputs and their timing.  Additionally, it allows the user to set
  30.      certain device parameters which are described below.  The defaults for
  31.      all of these controls are in the file /usr/etc/video/videod.defaults.vino
  32.      which is the file restored when the "File>Restore Factory Settings" is
  33.      selected.
  34.  
  35.      The following controls affect the IndyCam.  All but the first, which is
  36.      on the main panel, may be adjusted by bringing up the IndyCam panel under
  37.      the ``Pro'' menu option in the main videopanel window.
  38.  
  39.  
  40.      White Balance  The white balance button causes the camera to
  41.                     automatically configure the red and blue balances to
  42.                     achieve an overall even toned image.  For best results,
  43.                     hold up a well lit piece of white paper in front of the
  44.                     camera and click on white balance, the camera will then
  45.                     calibrate itself.
  46.  
  47.      Freeze         This button toggles the video stream from the camera on
  48.                     and off.  When the video is frozen, no video data is sent
  49.                     by the system.
  50.  
  51.      AGC Enable     This toggle button turns on or off the automatic gain
  52.                     control in the IndyCam.  When automatic gain control is
  53.                     on, the camera continually adjusts itself to changing
  54.                     lighting conditions in order to produce an even level of
  55.                     brightness.  When automatic gain control is off, it is up
  56.                     to the user or program to set the proper gain level.  If
  57.                     the gain is too low, then the picture will appear dark;
  58.                     when the gain is too high it will appear white or washed
  59.                     out.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  71.  
  72.  
  73.  
  74.      Shutter Speed  This multiple choice control lets you control the shutter
  75.                     speed of the camera.  A faster shutter speed lets in less
  76.                     light and may be used when the amount of light is too high
  77.                     to be compensated for by the gain control.
  78.  
  79.      Gain           This control is used when the automatic gain has been
  80.                     turned off.  It allows manual adjustment of the camera
  81.                     exposure.
  82.  
  83.      Red Balance    The red balance controls the proportion of red in the
  84.                     image.
  85.  
  86.      Blue Balance   The blue balance controls the proportion of blue in the
  87.                     image.
  88.  
  89.      Saturation     The saturation value affects the overall color intensity
  90.                     of the image.  When saturation is set to zero, the image
  91.                     will have no color.
  92.  
  93.    AAAAnnnnaaaalllloooogggg VVVViiiiddddeeeeoooo IIIInnnnppppuuuutttt CCCCoooonnnnttttrrrroooollllssss
  94.      The analog video input controls are used to configure the two standard
  95.      video input ports on the Indy.  The main panel has three controls on it:
  96.      lock to VTR, input source, and input timing.  The rest of the controls
  97.      are located on the analog video input panel under the ``Pro'' menu.
  98.  
  99.      Lock to VTR    This toggle controls the synchronization of the input
  100.                     video signal.  When enabled, the Vino analog port attempts
  101.                     to track the input signal continuously.  When disabled,
  102.                     the Vino analog port matches the input signal but does not
  103.                     make continual adjustments.  With video sources that
  104.                     fluctuate, the VTR lock usually generates a clearer
  105.                     picture.
  106.  
  107.      Input Source   This selects the default input source when the input is
  108.                     analog video.  The two choices correspond to the two
  109.                     connectors on the back of the machine.  The composite
  110.                     input is an RCA-type two wire connector that is commonly
  111.                     found on VCRs and cameras.  The S-Video input uses a
  112.                     mini-DIN connector that has separate signals for luminance
  113.                     and chrominance (sometimes referred to as Y/C).  Better
  114.                     VCRs and cameras support S-Video which generally results
  115.                     in a superior picture.
  116.  
  117.      Freeze         This button toggles the video stream from the camera on
  118.                     and off.  When the video is frozen, no video data is sent
  119.                     by the system.
  120.  
  121.      Prefilter      This toggle enables an analog signal filter that usually
  122.                     results in a cleaner picture with less ``sparkles''.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  137.  
  138.  
  139.  
  140.      Color Mode     This toggle controls the interpretation of color
  141.                     information in the signal.  If set to ``Auto'', then Vino
  142.                     attempts to detect the presence of color in the signal and
  143.                     enables color signal processing if it finds it.  If set to
  144.                     ``Color'' then Vino assumes the signal is color all the
  145.                     time.  If set to ``Mono'' then Vino disables and color
  146.                     signal processing.  When using a monochrome source,
  147.                     somewhat better picture quality may be obtained if the
  148.                     color mode is set to mono.  A very poor color signal may
  149.                     be mistaken for black and white in which case the
  150.                     ``Color'' setting may used to force recognition of color.
  151.                     See the description for ``Color Kill Threshold'' below for
  152.                     more information.
  153.  
  154.                     When Color Mode is set to color and you have a Composite
  155.                     input, then the chroma trap is on by default.  If you
  156.                     select an S-Video input then the chroma trap is off.  When
  157.                     the chroma-trap is on and you have a color composite
  158.                     picture, you may want to turn on the Pre-Filter to allow
  159.                     more of the luma signal to survive the chroma trap.
  160.  
  161.      Aperture       This adjustment affects the sharpness of the picture.
  162.                     There are 4 settings on this button as shown below.  Each
  163.                     affect the gain at various frequencies in the incoming
  164.                     signal.  There are curves published for the settings of
  165.                     this parameter in the "1993 Desktop Video Data Handbook"
  166.                     on page 3-220 in figures 22 and 23.  Each curve is labeled
  167.                     with a setting of the 7191 sub- address 06.  These match
  168.                     the settings in our software as follows:
  169.  
  170.                          7191 "06"       Video Control Panel
  171.                          Setting         Aperture Setting
  172.                          --------        -------------------
  173.                            80h                  0
  174.                            81h                  0.25
  175.                            82h                  0.5
  176.                            83h                  1.0
  177.  
  178.                     If the reader does not have access to the curves below is
  179.                     a quick table showing the rough gain/frequency pair for
  180.                     each setting.  The flatest response appears to be the 0.25
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  203.  
  204.  
  205.  
  206.                     setting.
  207.  
  208.                          Vy(dB) Gain Depending on Aperture Setting
  209.                          fy (MHz)   0     0.25    0.5    1.0
  210.                          --------  ---    ----    ---    ---
  211.                            0        3       3      3      3
  212.                            1        3       3      3      3
  213.                            2        3       3      3      3.5
  214.                            3        2.5     3      3.5    4
  215.                            4        2       3      4      5
  216.                            5        1.5     3      4.5    6
  217.                            6        1       3      4      6
  218.                            7        0       2      4      6
  219.                            8       -1       1      2.5    5
  220.  
  221.  
  222.      Coring         This adjustment also affects the sharpness of the picture.
  223.                     Coring is a form of noise reduction. The coring settings
  224.                     impact the bandpass filters output signal which is working
  225.                     with a 13 bit word precision.  The coring settings decide
  226.                     what thresholds of these lsbs in the 13 bit word affect
  227.                     the least significant bits of the 8 bit luma word.  The
  228.                     luma word has 8 bits Y7-Y0.  Coring says only Y0 bit will
  229.                     be affected for the setting of +/- 1LSB, Y0 and Y1 will be
  230.                     affected for the setting of +/- 2LSB  and Y0-Y2 will be
  231.                     affected for the setting of +/- 3LSB.  If you boost the
  232.                     gain of high frequency components in the bandpass or with
  233.                     the pre-filter then you should have some noise reduction
  234.                     which would be to turn coring off or set it to +/- 1LSB
  235.                     which would restrict the rounding after the bandpass to
  236.                     the least significant bit of the final 8 bit monochrome
  237.                     value.
  238.  
  239.      Bandpass       This adjustment also affects the sharpness of the picture.
  240.                     The bandpass filter can be programmed to different
  241.                     frequencies even when the chroma trap is bypassed.  The
  242.                     figures in the databook do not show the frequency response
  243.                     for this bandpass filter independently.
  244.  
  245.      Vertical Noise The vertical noise setting controls the analog video
  246.                     recognition of frame boundaries.  Different types of video
  247.                     sources may need different settings to obtain a stable
  248.                     picture.
  249.  
  250.      Hue            The hue adjusts the balance between colors in the signal.
  251.  
  252.      Color Kill Threshold
  253.                     The color kill threshold sets the minimum level at which a
  254.                     color signal will be recognized.  A poor color input
  255.                     signal may cause the automatic color detection logic to
  256.                     oscillate between monochrome and color.  This adjustment
  257.                     allows the user to control the minimum signal needed to
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  269.  
  270.  
  271.  
  272.                     enable color signal processing.
  273.  
  274. PPPPRRRROOOODDDDUUUUCCCCTTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC IIIISSSSSSSSUUUUEEEESSSS
  275.      The video daemon software automatically probes for the active video
  276.      inputs when it is first started.  The order or precedence in selecting
  277.      the default input is:
  278.  
  279.          Input signal(s) active:
  280.  
  281.             svideo  composite  indycam  default_input
  282.             ------  ---------  -------  -------------
  283.            yes      x         x        svideo
  284.            no       yes       x        composite
  285.            no       no        yes      indycam
  286.            no       no        no       composite (if "vinopro" off)
  287.            no       no        no       ccir-601  (if "vinopro" on)
  288.  
  289.  
  290.                                        NOTE
  291.  
  292.      "Vinopro" config option is described below under the "ALTERNATE VINOPRO
  293.      CONTROL PANEL" section.
  294.  
  295.      This allows you, for example, to use the VCR's power button to change the
  296.      default input between it and the IndyCam when first starting up the video
  297.      daemon.
  298.  
  299.                                        NOTE
  300.  
  301.      Whether the video daemon starts at systems start up time is controlled by
  302.      the videod "chkconfig" option.  If it's on, then the video daemon is
  303.      started when the system first boots.  If it's off, then the video daemon
  304.      is not started until the first video application is started.
  305.  
  306.      Input timing and source may be changed while any video application is
  307.      running but also might cause loss of sync and undesired effects.  This
  308.      also applies to restoring the factory settings.
  309.  
  310.      Some VCR's don't produce stable NTSC or PAL signals when some tape
  311.      transport functions are employed.  For example, switching from PLAY to
  312.      FAST FOWARD often results in a disruption of the video sync and may cause
  313.      VINO to become confused.  The system software attempts to restart the
  314.      video capture but it may not be able to and will then return a error to
  315.      the application.
  316.  
  317.      The default control values have no effect until a video path is created.
  318.      They are used as suggestions for applications such as videoin to specify
  319.      the desired input source.
  320.  
  321.      The video tools supplied are vvvviiiiddddeeeeooooiiiinnnn, vvvviiiiddddeeeeooooppppaaaannnneeeellll, vvvviiiiddddttttoooommmmeeeennnn and vvvvlllliiiinnnnffffoooo.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  335.  
  336.  
  337.  
  338. VVVVIIIIDDDDEEEEOOOO DDDDAAAATTTTAAAA TTTTRRRRAAAANNNNSSSSFFFFEEEERRRR
  339.      VINO supports frame(field) capture that is decimated in both the X and Y
  340.      directions. Decimation of sizes 1/2th, 1/3rd, 1/4th, 1/5th, 1/6th, 1/7th
  341.      and 1/8th are supported, though the color quality suffers at the smaller
  342.      ranges.  To compensate for this limitation, the system software initiates
  343.      a decimation conversion for values 1/4th, 1/6th and 1/8th by doing the
  344.      first half of the decimation in hardware and the second half of the
  345.      decimation in software.  This affects the software overhead required for
  346.      capturing video.
  347.  
  348.      The user can also clip the frame in the X and Y direction but VINO cannot
  349.      clip inward from the right hand edge.  If an attempt to set the VL_SIZE
  350.      and/or VL_OFFSET to values that would result in the right hand edge to
  351.      not be the end of the active video line, a VLBadValue error is returned
  352.      and the value is adjusted to be correct.
  353.  
  354.      Vino cannot capture a video line whose size is exactly divisable into
  355.      4096.  For example, if a video line is to be packed into 32 bit RGBA
  356.      pixels and the VL_SIZE set to 512, then the resultant line size would be
  357.      2048 which is exactly divisable into 4096.  If an attempt to set a
  358.      VL_SIZE value creates this condition, the system software will adjust the
  359.      VL_SIZE value to be a the next higher allowable size.
  360.  
  361.      As with all VL devices, a vlGetControl should always follow a
  362.      vlSetControl to get the actual value that was accepted.
  363.  
  364. AAAALLLLTTTTEEEERRRRNNNNAAAATTTTEEEE VVVVIIIINNNNOOOOPPPPRRRROOOO CCCCOOOONNNNTTTTRRRROOOOLLLL PPPPAAAANNNNEEEELLLL
  365.      There are certain Indy applications that use the IndyCam connector to
  366.      support CCIR-601 format.  To enable these controls on the Video Control
  367.      Panel a configuration option is provided using the "chkconfig" command.
  368.      To enable this option, the following commands should be entered in a
  369.      shell window:
  370.  
  371.           su
  372.           chkconfig -f vinopro on
  373.           exit
  374.  
  375.      This command must be entered before the video daemon, videod is started,
  376.      which is usually when the first video application is started.  To restart
  377.      the video daemon, the following commands are used:
  378.  
  379.           su
  380.           killall videod
  381.           /usr/etc/videod
  382.           exit
  383.  
  384.      Note that the format for the IndyCam input may be "IndyCam" or "CCIR-
  385.      601".  Selecting IndyCam changes the "timing" to be "IndyCam NTSC" which
  386.      may not be changed.  Selecting "CCIR-601", allows selection of all
  387.      timings except "IndyCam NTSC".
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. VVVVIIIINNNNOOOO((((7777))))                                                                VVVVIIIINNNNOOOO((((7777))))
  401.  
  402.  
  403.  
  404. SSSSUUUUPPPPPPPPOOOORRRRTTTTEEEEDDDD PPPPAAAACCCCKKKKIIIINNNNGGGG FFFFOOOORRRRMMMMAAAATTTTSSSS
  405.      The following VL packing formats are supported by vino.
  406.  
  407.          VL_PACKING_RGB_332_P
  408.          VL_PACKING_RGBA_8
  409.          VL_PACKING_RGB_8
  410.          VL_PACKING_Y_8_P
  411.          VL_PACKING_YVYU_422_8
  412.  
  413. FFFFIIIILLLLEEEESSSS
  414.      /usr/lib/dmedia/video/vino.so /usr/etc/video/videod.defaults.vino
  415.  
  416. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  417.      videopanel(1), videoin(1), vlinfo(1), vidtomem(1), vlintro(3dm)
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.